-
-
-
- <para> Support for the "Garmin GPS Database" format used by
-default in MapSource versions since release 6.0. By default we create
-gdb's of version 2. Version 2 is used in Mapsource 6.3 and 6.5.
+<para>
+Support for the "Garmin GPS Database" format used by
+default in MapSource versions since release 6.0. By default GPSBabel creates
+gdb files of version 2. Version 2 is used in Mapsource 6.3 and 6.5.
</para>
- <para> Garmin GPS database is an undocumented file format. The
-basic info for this module comes from the existing MapSource
+<para>
+Garmin GPS database is an undocumented file format. The
+basic info for this module came from the existing MapSource
conversion code.
</para>
- <para> Additional options:</para>
- <para>
- <option>ver</option> - set the data format version of the
-output file (currently 1 or 2); 2 is our default. </para>
- <para>
- <option>via</option> - Drop hidden route points (means
-calculated stuff)</para>
- <para>
- <option>cat</option> - default category on output
-(1..16)</para>
-
-
-
- <para>Input and output support for IGN Rando track files. IGN
-Rando is a program mainly used in France for Topo maps. The files are
-XML based and are "windows-1252" encoded. Trackpoints come without
-timestamp.</para>
- <para>
- Options:
- </para>
- <para>
- <option>index</option> - Use track number <index>
-from input data for output. The range is 1 to number of tracks in
-input.
+<para>
+This format supports IGN Rando track files. IGN Rando is a program mainly
+used in France for Topo maps. The files are XML based and are "windows-1252"
+encoded. Trackpoints do not have time stamps.
</para>
-
-
-
- <para> KML, the Keyhole Markup Language, is used by Keyhole and
-Google Earth. (Google Earth uses GPSBabel internally for receiver
-communications and several file format imports and exports. There are
-features in this file format that we don't support such as camera
-views, but waypoints, tracks, and routes work well.</para>
- <para>Additional options:</para>
- <para>
- <option>lines=n</option> (default n=1) Draws lines between
-points in tracks and routes when n is non-zero.</para>
- <para>
- <option>points=n</option> (default n=1) Draws placemarks
-for tracks and routes when n is non-zero.</para>
- <para>
- <option>line_width=n</option> (default n=6) Width of drawn
-lines, in pixels.</para>
- <para>
- <option>line_color=n</option> (default=65eeee17) Line
-colour specified in hex AABBGGRR.</para>
- <para>
- <option>floating=n</option> (default n=0) Altitudes are
-not clamped to ground when n is non-zero. This option is more useful
-to pilots than to hikers.</para>
-
+<para>
+KML, the Keyhole Markup Language, is used by Keyhole and
+Google Earth. There are features in this file format that GPSBabel
+doesn't support - such as camera views - but waypoints, tracks, and routes
+work well.
+</para>
+<para>
+Google Earth also uses GPSBabel internally for receiver communications
+and several file format imports and exports.
+</para>
-
-
-
- <para> NetStumbler 0.4 Summary File -- Another CSV format file.
+<para>
+This format reads summary files from <productname>NetStumbler</productname>
+<productnumber>0.4</productnumber> or <productname>MacStumbler</productname>.
+</para>
+<para>
The default behavior when creating waypoints is to use the SSID for
the short name, and information about the access point for the
description. When the SSID is not unique, is not available, or
-consists of whitespace, a shortname is synthesized. The snmac option
-uses the MAC address for the shortname, and includes the unmodified
-SSID in the description. Different icons are assigned to encrypted,
+consists of whitespace, a short name is synthesized.
+</para>
+<para>
+Different icons are assigned to encrypted,
non-encrypted, stealth, and non-stealth access points; these may be
-changed with options. Import only.
+changed with options.
+</para>
+<para>
+<ulink url="http://www.netstumbler.com/">NetStumbler</ulink>
+</para>
+<para>
+<ulink url="http://www.macstumbler.com/">MacStumbler</ulink>
</para>
-<para>This format also works with MacStumbler.</para>
- <para> Additional options:</para>
- <para>
- <option>nsneicon</option> - Name of icon used for
-non-stealth non-encrypted access points</para>
- <para>
- <option>seicon</option> - Name of icon used for stealth
-encrypted access points</para>
- <para>
- <option>sneicon</option> - Name of icon used for stealth
-non-encrypted access points</para>
- <para>
- <option>snmac</option> - Always use the MAC address as the
-shortname.</para>
-
-
+<para>
+This option specifies the default category for gdb output. It should be a
+number from 1 to 16.
+</para>
-
+<para>
+This options specifies the data format version for the output file. Version
+2 is the default. Currently, the only other valid value for this option is
+1.
+</para>
-
+<para>
+This option instructs GPSBabel to drop hidden (calculated) points from
+routes.
+</para>
+
+<para>
+Because the format supports only one track, this option can be used
+on output to select a single track from a collection of
+tracks read from a more expressive format. If you have, say, a
+<link linkend="fmt_gpx">gpx</link> file that contains two tracks, you can
+use this option to write them one at a time to individual files.
+</para>
+<screen format="linespecific">gpsbabel -i gpx -f tracks.gpx -o ignrando,index=1 -F track1.txt -o ignrando,index=2 -F track2.txt</screen>
-
+<para>
+This option specifies the default name for waypoint icons
+</para>
-
+<para>
+When this option is nonzero, altitudes are allowed to float above or below
+the ground surface. By default, this option is zero so that altitudes are
+clamped to the ground. Specify <option>floating=1</option> to allow them to
+float.
+</para>
+<para>
+This option is more useful to pilots than to hikers.
+</para>
+<para>
+This option specifies the line color as a hexadecimal number in
+AABBGGRR format, where A is alpha, B is blue, G is green, and R is red.
+</para>
-
+<para>
+This option specifies the width of the drawn lines in pixels. The default
+value is six pixels.
+</para>
-
+<para>
+When this option is nonzero, GPSBabel draws lines between points in
+tracks and routes. The default value for this option is 1, which causes
+lines to be drawn by default. To disable line-drawing, specify
+<option>lines=0</option>.
+</para>
+<para>
+When this option is nonzero, GPSBabel draws placemarks for tracks and routes.
+The default value for this option is 1, which causes placemarks to be drawn.
+To disable drawing of placemarks, specify <option>points=0</option>.
+</para>
-
+<para>
+This option specifies the name of the icon to use for
+non-stealth, encrypted access points.
+</para>
-
+<para>
+This option specifies the name of the icon to use for
+non-stealth, non-encrypted access points.
+</para>
-
+<para>
+This option specifies the name of the icon to use for
+stealth, encrypted access points.
+</para>
-
+<para>
+This option specifies the name of the icon to use for
+stealth, non-encrypted access points.
+</para>
-
+<para>
+This option causes GPSBabel to use the MAC address as the short name for the
+waypoint. The unmodified SSID is included in the waypoint description.
+</para>
projects / gpsbabel.git / commitdiff